【企业微信】新增创建企业群发API接口支持tag_filter参数设置。#3920
Hidden character warning
【企业微信】新增创建企业群发API接口支持tag_filter参数设置。#3920Winnie-by996 wants to merge 1 commit intobinarywang:developfrom
Conversation
🤖 Augment PR SummarySummary: 为企业微信“创建企业群发”请求模型补充按客户标签筛选能力（
add_msg_template 请求体，结构对齐官方文档 tag_filter.group_list[].tag_list。
🤖 Was this summary useful? React with 👍 or 👎 |
![augmentcode[bot]](https://avatars.githubusercontent.com/in/1027498?s=60&v=4){kind=small}
| /** | ||
| * 要进行群发的客户标签列表，同组标签之间按或关系进行筛选，不同组标签按且关系筛选，每组最多指定100个标签，支持规则组标签 | ||
| */ | ||
| @SerializedName("tag_filter") |
There was a problem hiding this comment.
根据官方“创建企业群发”文档，sender/external_userid/tag_filter 不能同时为空，且当指定 external_userid 时 tag_filter 不生效。建议在 tagFilter（以及相关字段）的注释中补充这些约束，避免调用方误用。
Severity: low
🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.
| private static final long serialVersionUID = -6756444546744020234L; | ||
|
|
||
| @SerializedName("group_list") | ||
| private List<TagList> groupList; |
There was a problem hiding this comment.
tag_filter 的 JSON 层级（group_list[].tag_list）比较容易在后续重构中回归，考虑补一个简单的序列化单测断言 WxCpMsgTemplate.toJson() 输出结构与文档示例一致。
Severity: low
🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.
There was a problem hiding this comment.
Pull request overview
该 PR 为企业微信「创建企业群发」消息模板对象补充 tag_filter 参数的数据结构与序列化字段支持，以便调用方在群发任务创建时按客户标签规则进行筛选。
Changes:
- 新增
TagFilter/TagList两个 bean，用于承载tag_filter.group_list[].tag_list的 JSON 结构 - 在
WxCpMsgTemplate中新增tagFilter字段并增加@SerializedName("tag_filter")映射
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/external/msg/TagList.java | 新增标签列表承载对象（tag_list） |
| weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/external/msg/TagFilter.java | 新增标签筛选承载对象（group_list） |
| weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/external/WxCpMsgTemplate.java | 模板新增 tag_filter 字段以支持按标签筛选 |
| /** | ||
| * 要进行群发的客户标签列表，同组标签之间按或关系进行筛选，不同组标签按且关系筛选，每组最多指定100个标签，支持规则组标签 | ||
| */ | ||
| @SerializedName("tag_filter") | ||
| private TagFilter tagFilter; |
There was a problem hiding this comment.
这里新增 tagFilter 字段会导致 Lombok 生成的 @AllArgsConstructor 构造函数签名发生变化，从而对依赖 new WxCpMsgTemplate(...) 的存量调用方造成编译期破坏（SDK 公共 API 兼容性问题）。建议保留一个与此前参数列表一致的显式构造函数并标注 @deprecated（内部委托到新构造/为 tagFilter 赋默认值 null），或评估是否可以移除/替换 @AllArgsConstructor 以避免后续继续出现类似破坏性变更。
feat: WxCpMsgTemplate 增加tag_filter支持.